home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1996 June / EnigmA AMIGA RUN 08 (1996)(G.R. Edizioni)(IT)[!][issue 1996-06][EARSAN CD VII].iso / earcd / utilgfx / unvrsl36.rdm < prev    next >
Text File  |  1996-05-20  |  16KB  |  348 lines
  1. Short:    Photogenics universal loader&animation saver
  2. Author:   hhoff@pool.informatik.rwth-aachen.de (Helmut Hoffmann)
  3. Uploader: hhoff@pool.informatik.rwth-aachen.de (Helmut Hoffmann)
  4. Type:     gfx/edit
  5. Kurz:     Photogenics-Univ.Lader&Anim.speichermodul
  6.  
  7. HHsFastUniversalGioModules 3.6
  8. ==============================
  9.  
  10. +++ including fast PhotoCD loading support (correct orientation) and support
  11.     for over 20 other file formats and additionally DataTypes! +++
  12. +++ including TrueColor animation creation support (see below) +++
  13.  
  14. -> new: now with optional downscaled loading option... gets your "too large"
  15.    pictures into Photogenics in reduced size... <-
  16.  
  17. -> new: create your own animations with Photogenics e.g. for CyberGraphX,
  18.    EGS or OS3.x-Amigas with the included HHsYUVSq sequence saver module; see
  19.    below for details!! <-
  20.  
  21. Warning: I am aware that illegal/modified keyfiles of this module may exist.
  22. !Use of such keyfiles ("hhsgiokey.library") is strictly prohibited and
  23. !can lead to undefined results and problems! For a program which you use
  24. !you should also be willing to pay the shareware fee. Only if enough users
  25. !register I will be able to do further improvements or create other graphic
  26. !applications. You can also help me by sending me illegal keyfiles of
  27. !this product which you find somewhere.
  28.  
  29. The fast universal loader module can be used with Photogenics (I have tried
  30. it with Photogenics V1.2; it should also be usable partially with older
  31. versions; it will probably NOT be usable with Photogenics Lite or Demo
  32. versions, so better get the full version of Photogenics...; DataTypes option
  33. and downscaled loading option are only usable with Photogenics V1.2 or higher).
  34. It is shareware; without a keyfile which you get after registration,
  35. it will load all pictures in greyscale, regardless if they are color or not,
  36. but the speed and format support is the same, so that you can try if
  37. the module fits your needs.
  38.  
  39. The loader module currently supports the following file formats:
  40.  
  41. * IFF-ILBM (all standard formats 1 to 8Bit, EHB, HAM6, HAM8, 24Bit)
  42. * PhotoCD (Base format 768x512 or 512x768 (portrait); linear 24Bit colors)
  43. * PPM/PGM/PBM (P1&P4 b&w, P5 grey, P6 color)
  44. * QRT (also known as dump format by PD raytracers as POV-Ray)
  45. * Targa (RLE compr.&uncompr. 1/8/15/16/24/32Bit;incl. interleaved)
  46. * PCX (compr.&uncompr. EGA1-4Bit, VGA 8Bit grey/Colormap and 24Bit)
  47. * MacPaint (b&w compressed 1Bit format; datafork only)
  48. * BMP (uncompr. 24Bit RGB,1Bit,4Bit or 8Bit Colormap; RLE compressed 8Bit,1Bit)
  49. * TIF (packbit-compr.&uncompr. 24Bit,1-8Bit grey/Color Motorola&Intel formats)
  50. * EGS7.x window iconification file format
  51. * DEEP (compr.&uncompr. 24Bit and 32Bit)
  52. * RGB formats (RGB8, RGBN, RGB5)
  53. * ACBM formats (1 to 8Bit, incl. HAM6/HAM8)
  54. * FBM formats (8Bit grey/color and 24Bit)
  55. * IFF-PBM (DPII) format
  56. * Sun raster (1Bit, 8Bit grey/color and 24Bit uncompressed)
  57. * YUV (color 1:1:1, 2:1:1, 4:1:1 and greyscale)
  58. * VLAB raw (color 1:1:1, 2:1:1, 4:1:1 and greyscale)
  59. * HHsYUVSq sequence format (sequential or random access)
  60. * HHsXRL formats (1-8Bit ColorMap incl. HAM6/8, 8Bit grey, 24Bit RGB compressed)
  61. * binary-EPS bitmaps (RGB and CMYK; this function is experimental)
  62. * TBCPlus frames&fields
  63.  
  64. * DataType (incl. first frame of animations with Anim-Datatypes)
  65.   DataTypes are only used as option (if selected in the "Prefs" for
  66.   the module; see below for details)
  67.  
  68. To install the modules, just copy the file ending with ".gio" to your
  69. Photogenics:Data/Gio directory or use the install script.
  70.  
  71. The name of the loader .gio module starts with a "-" so that it appears
  72. first in the list of loader modules (and usually will be tried first
  73. for automatic format detection). This makes sure that the fast module
  74. is used automatically instead of other modules if it can load a format.
  75. This should make your loading of many formats much faster!
  76.  
  77. Preferences: Select Prefs button when the loader is selected in the loader
  78.          list; Preferences for GIO modules are only available with
  79.          Photogenics V1.2 and higher!
  80. a) Datatype support: Select "On" if you want Datatypes to be used if the
  81.  internal file formats of UniversalGIO fail; Please note that if this
  82.  option is selected all files which are not supported internally by
  83.  UniversalGIO will be tried by Datatypes which can take some additional
  84.  time or lead to unwanted results (if you have a bad Datatype which
  85.  then loads a picture instead of one of the original Photogenics GIOs).
  86. b) Downscaling factor: Select a downscaling factor (greater 1) in the
  87.  range 1..16 if you want to get pictures into Photogenics in downscaled
  88.  form; useful if memory is insufficient to load big pictures in full size.
  89.  Please note that some of the file formats (which can not be loaded line
  90.  by line) may still need full memory during loading; most formats will
  91.  only need memory for reduced size. Some file formats may also support
  92.  only certain downscale factors. In this case the next higher available
  93.  downscaling factor will be used.
  94.  
  95. About:    Select About button when the loader is selected in the loader
  96.     list to get information about your keyfile (registered users)
  97.     and the supported file formats; About for GIO modules is only
  98.     availabe with Photogenics V1.2 and higher!
  99.  
  100. Example loading speed advantages on my configuration (see below):
  101.  
  102. ACBM: upto 2 times faster
  103. BMP:  upto 2.3 times faster (in addition some OS2-styles supported)
  104. DEEP: upto 1.3 times faster (in addition compressed images are supported)
  105. IFF-EHB: upto 2.5 times faster
  106. HAM6: upto 1.5 times faster (in addition colors can be better)
  107. HAM8: upto 1.7 times faster (in addition colors at left border should be correct)
  108. IFF-24Bit: upto 2.4 times faster
  109. IFF-8Bit: upto 2.2 times faster
  110. PPM-P6: upto 2.3 times faster
  111. PPM-P5: upto 3.1 times faster
  112. PCX: upto 3.8 times faster (in addition special EGA/VGA styles supported)
  113. PhotoCD: upto 3 times faster (in addition horizontal images are usually
  114.                 loaded in correct orientation)
  115. QRT: upto 1.3 times faster
  116. Targa: upto 1.7 times faster (this test in RAM: due to loading problems with
  117.     original loader from harddrive; in addition compressed images and other
  118.     depths supported)
  119. TIF: upto 3.3 times faster
  120. (GIF: upto 2 times faster with DataType-Loading and a fast GIF datatype)
  121.  
  122. (only loading times compared, not displaying; my configuration: Amiga 3000;
  123.  68030/25MHz;PiccoloSD64;Photogenics 1.2;loading from Quantum harddrive; PhotoCD
  124.  loading from NEC2x; Please note that loading times can differ much on other
  125.  configurations)
  126.  
  127. In addition to the speed advantages, many new formats are supported as
  128. well (see above).
  129.  
  130. The fast loading functions have all been written by me in assembler and
  131. optimized for fastest speed. I did this for my famous shareware programs
  132. CyberShow, EGSPhotoAlbum and EGS-TV. When new formats are implemented
  133. for my other programs (or the speed is improved further), I will usually
  134. also update the modules, which registered user can then use due to the
  135. keyfile concept.
  136.  
  137.  
  138. HHsYUVSq sequence/animation saver GIO module
  139. ============================================
  140.  
  141. In addition to the universal loader now an animation saver module
  142. is part of this package...
  143.  
  144. The HHsYUVSq.gio module can be used to create animations with Photogenics
  145. in the famous HHsYUVSq sequence format. For playback of such animations
  146. you can use:
  147.  
  148.  a) CyberTVPlayer (Freeware) (available e.g. on Aminet gfx/board)
  149.  
  150.   Can play such animations in HiColor/TrueColor like quality on CyberGraphX
  151.   HiColor/TrueColor Workbench.
  152.   Can play such animations in reduced color (2 to 256) on any Amiga Workbench
  153.   if at least OS3.0 is available.
  154.   CyberTVPlayer plays animations direct from disk and can thus be used
  155.   to play animations of any size! For faster speed you could copy small
  156.   sequences to RAM: before playing them.
  157.  
  158.  b) EGSTVPlayer (Freeware) (available e.g. on Aminet gfx/board)
  159.  
  160.   Can play such animations on EGSDefault Screen in conjunction with the
  161.   EGS graphic environment (TrueColor/HighColor or reduced color).
  162.   EGSTVPlayer plays animations direct from disk and can thus be used
  163.   to play animations of any size! For faster speed you could copy small
  164.   sequences to RAM: before playing them.
  165.  
  166.  c) EGS-TV Professional (Shareware) (available e.g. on Aminet gfx/board)
  167.  
  168.   Can edit and play such animations (insert frames, append frames, delete
  169.   frames; special effects "Blue Screen Keying" etc).
  170.  
  171. In demo version the module will create sequences only in greyscales,
  172. so please support shareware and register for my UniversalGIO module now...
  173.  
  174. By the way: Similair modules are available for ImageFX (FastIFXModules)
  175. and XiPaint (XiPaintModule) as well. Both now also include HHsYUVSq animation
  176. creation and feature ARexx scripts for automatic conversions!
  177. I hope that ARexx scripts are possible with future Photogenics versions
  178. as well.
  179.  
  180. TrueColor animation creation with HHsYUVSq GIO module
  181. ----------------------------
  182.  
  183. Using the animation saver module:
  184.  
  185.  a) Create a new sequence
  186.  
  187.   Just save the picture which you want to become the first frame of your
  188.   animation with the HHsYUVSq.gio saver. In the file requester you should
  189.   select a new filename. The GIO module will then try to create a sequence
  190.   with this name.
  191.  
  192.   Important: Image dimensions are limited! Only even wide images can be
  193.   used to create a sequence; the image wide must be in the range 80..360.
  194.   The image height must be in the range 64..310!
  195.  
  196.   If you have a collection of much bigger images you can use the new
  197.   downscaled loading option of my UniversalGIO loader module to get the
  198.   images in downscaled form into Photogenics quickly...
  199.  
  200.  b) Append a frame to a sequence
  201.  
  202.   Just save the picture which you want to append to an animation with the
  203.   HHsYUVSq.gio saver. In the file requester you should select the filename
  204.   of the animation to which the frame should be appended.
  205.  
  206.   New: If you have at least Photogenics V1.2 you can select "Prefs" options
  207.   for the saver: an option allows to make file name selection permanent; if
  208.   this is selected, the file name of the sequence will only be requested
  209.   once (as long as the saver module is not flushed out of memory), enabling
  210.   you to simply append frames by calling the saver. If you want to change
  211.   the file name later, you first have to deselect this Prefs option. This
  212.   option should be esp. useful if a future version of Photogenics becomes
  213.   available with ARexx support, so that automatic appending of multiple
  214.   frames becomes possible (this is already possible with ImageFX and
  215.   XiPaint for which I have created similair modules).
  216.  
  217.   Important: You can only append images of the correct size to a sequence.
  218.   Differently sized images can not be saved in one sequence. Please scale or
  219.   crop the images to the size of the first frame in the sequence.
  220.  
  221. Special note for EGS-TV users: You can load and edit sequences created with
  222.  this module with EGS-TV as well. In the other way this is only possible if
  223.  the sequence is of the right kind (color,sequential mode,half frame/LoRes).
  224.  
  225. Registration of UniversalGIO Modules
  226. ====================================
  227.  
  228. You can register for the modules at the small add-on price of only 8US$ or
  229. 10DM if you order it together with one of my other shareware programs,
  230. e.g. CyberShow, the universal viewer and slideshow program for all Amigas
  231. with at least OS3.0 (loading the same formats as the UniversalGIO and
  232. additionally JPeg) or EGSPhotoAlbum or EGS-TV. Please use the registration
  233. forms of thoose programs and specify your add-on module order there and
  234. include the extra amount.
  235.  
  236. Otherwise you should use the supplied registration form to register.
  237.  
  238. If you only want to register for the modules, the registration fee is
  239. 18US$ outside europe or 20DM in europe. You will also get the latest demo
  240. versions of my other programs. Additional modules (XiPaintModule for
  241. XiPaint or FastIFXModules for ImageFX) can be ordered at the lower
  242. add-on price.
  243.  
  244. If you are already a registered user of one of my programs and now want to
  245. register for the modules, the registration fee is 13US$ outside europe or
  246. 15DM (in europe). Additional modules (e.g. XiPaintModule for XiPaint or
  247. FastIFXModules for ImageFX) can be ordered at the lower add-on price.
  248.  
  249. (Special note for users in germany only: Wenn Sie schon registrierter Benutzer
  250.  eines meiner Shareware-Programme sind und sich Ihre Anschrift nicht
  251.  geändert hat, können Sie die Module direkt per Überweisung bestellen.
  252.  Als Verwendungszweck geben Sie bitte "UniGIO für ...." an, wobei Sie
  253.  das Programm was Sie schon haben und die Registriernummer angeben.
  254.  Zusätzlich möglichst auch noch Name/Anschrift; die Bankverbindung:
  255.  Konto-Nr. 5740147 BLZ 310 500 00 Stadtspark. Mönchengladbach)
  256.  (No bank transfers from outside germany!)
  257.  
  258. Send your filled in registration form together with cheque, international
  259. postal money order or banknotes to:
  260.  
  261.     Helmut Hoffmann
  262.     Rubensstrasse 4
  263.     D-41063 Moenchengladbach
  264.     Germany
  265.  
  266. Special Thanks
  267. ==============
  268.  
  269. My special thanks go to Mr. J. Ralph and Almathera for their kind support.
  270.  
  271. Disclaimer
  272. ----------
  273.  
  274. This software (program and documentation) is provided "as is" and
  275. comes with no warranty, either expressed or implied.
  276. The author is in no way responsible for any damage or loss that may
  277. occur due to direct or indirect usage of this software. You use
  278. this software entirely at your own risk.
  279.  
  280. Copyright and Distribution
  281. --------------------------
  282.  
  283. HHsFastUniversalGioModules (modules and documentation) is
  284. copyright by
  285.  
  286.     Helmut Hoffmann
  287.     Rubensstrasse 4
  288.     D-41063 Moenchengladbach
  289.     Germany
  290.  
  291. The demo version may be freely distributed and used as
  292. long as the following conditions are met:
  293.  
  294. 1) All files have to be kept together
  295.  
  296. 2) No file may be modified or crunched/packed.
  297.  
  298.    The only official way to distribute the demo packed is the
  299.    original universalgio.lha archive.
  300.    The modules may not be disassembled or analysed. The limitations
  301.    integrated in the demo version may under no circumstance be removed
  302.    or bypassed.
  303.  
  304. 3) Distributors may only charge for the duplication process (including media)
  305.    and not for the software. Theese charges may not exceed the following
  306.    limits: a) Demo on a PD-disk: 7$ (US-dollar) including
  307.               postage&packing (in Germany: 10DM)
  308.        b) Demo on a PD-CD-ROM: 40$ (US-dollar) including
  309.               postage&packing (in Germany: 60DM)
  310.        c) Demo on a BBS/Mailbox/ftp-site or other electronically
  311.               callable system: Maximum charge 3$ (US-dollar) (in Germany: 5DM)
  312.               for downloading
  313.    Anyway, it must be made explictly clear to the buyer, that he does not
  314.    pay for the modules (demo) itself but only for the duplication service.
  315.  
  316. 4) It is not allowed to distribute this demo with any commercial product
  317.    without a written permission by me. One exception is the distribution of
  318.    the demo version with products not exceeding the above price limits (e.g.
  319.    a cover-disk magazine for 7$ or less).
  320.  
  321.    The following companies have my explicit permission to distribute the
  322.    demo with their products: Almathera, Ingenieurbüro Helfrich, MacroSystem.
  323.  
  324. 5) The registered version may not be redistributed. It may only run on one
  325.    machine per registration. It is allowed to make a backup copy of the
  326.    original disk.
  327.  
  328. Version history
  329. ---------------
  330.  
  331. V1.0 (5th aug. 95): Initial release supporting 20 file formats and DataTypes
  332. V1.1 (21th aug. 95): First full version release (incl. revised documentation)
  333. V2.0 (29th aug. 95): Support new file formats: binary-EPS bitmaps (RGB,CMYK)
  334.             and TBCPlus frames/fields
  335. V2.1 (20th sep. 95): Show Datatype specific ID string during Datatype loading
  336. V3.0 (27th sep. 95): Support downscaled loading as option
  337.              Included GIO saver module to create HHsYUVSq animations
  338.             (for playback you can use CyberTVPlayer or EGSTVPlayer)
  339. V3.1 (28th sep. 95): HHsYUVSq animation saver extended by Prefs option to
  340.             make sequence file selection permanent
  341. V3.2/a (9th oct. 95): Extended TIF loader to support "Intel" byte order files
  342.             and more variants
  343. V3.3 (15th nov. 95): Extended IFF loader to support 0-length chunks
  344.              Added support to load partially defective files
  345. V3.4 (20th feb. 96): Extended IFF loader to accept unusual sized color maps
  346. V3.5 (24th march 96): Changed PCX loading for more compatibility
  347. V3.6 (29th april 96): Extended PCX loading for even more compatibility
  348.